package jdk8.timeapi;

import java.time.Clock;
import java.time.Duration;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.Month;
import java.time.ZoneId;
import java.time.ZonedDateTime;

/**
 * Description: jdk1.8新特性：Date/Time API
 * Java 8引入了新的Date-Time API(JSR 310)来改进时间、日期的处理。时间和日期的管理一直是最令Java开发者痛苦的问题。
 * java.util.Date和后来的java.util.Calendar一直没有解决这个问题（甚至令开发者更加迷茫）。
 * 因为上面这些原因，诞生了第三方库Joda-Time，可以替代Java的时间管理API。
 * Java 8中新的时间和日期管理API深受Joda-Time影响，并吸收了很多Joda-Time的精华。
 * 新的java.time包包含了所有关于日期、时间、时区、Instant（跟日期类似但是精确到纳秒）、duration（持续时间）和时钟操作的类。
 * 新设计的API认真考虑了这些类的不变性（从java.util.Calendar吸取的教训），如果某个实例需要修改，则返回一个新的对象。
 * 
 * 个人认为：哇这个东西，无敌有用再也不用之前那样写三行代码。。。不过这里没有说日期格式可不可以自定义
 * @author Kwum
 * @date 2017年6月28日 下午4:03:38
 * @version 1.0
 */

public class Run {

    public static void main(String[] args) {
        
        // Get the system clock as UTC offset
        Clock clock = Clock.systemUTC();
        System.out.println( clock.instant() );
        //等同 System.currentTimeMillis()
        System.out.println( clock.millis() );
        
        //LocalDate仅仅包含ISO-8601日历系统中的日期部分；
        //LocalTime则仅仅包含该日历系统中的时间部分。
        //这两个类的对象都可以使用Clock对象构建得到。
        // Get the local date and local time
        LocalDate date = LocalDate.now();//本地日期
        LocalDate dateFromClock = LocalDate.now( clock );
        System.out.println( date );
        System.out.println( dateFromClock );

        // Get the local date and local time
        LocalTime time = LocalTime.now();//本地时间
        LocalTime timeFromClock = LocalTime.now( clock );
        System.out.println( time );
        System.out.println( timeFromClock );
        
        //LocalDateTime类包含了LocalDate和LocalTime的信息，但是不包含ISO-8601日历系统中的时区信息
        // Get the local date/time
        LocalDateTime datetime = LocalDateTime.now();
        LocalDateTime datetimeFromClock = LocalDateTime.now( clock );
        System.out.println( datetime );
        System.out.println( datetimeFromClock );
        
        //如果需要特定时区的data/time信息，则可以使用ZoneDateTime，它保存有ISO-8601日期系统的日期和时间，而且有时区信息。
        // Get the zoned date/time
        ZonedDateTime zonedDatetime = ZonedDateTime.now();
        ZonedDateTime zonedDatetimeFromClock = ZonedDateTime.now( clock );
        ZonedDateTime zonedDatetimeFromZone = ZonedDateTime.now( ZoneId.of( "America/Los_Angeles" ) );

        System.out.println( zonedDatetime );
        System.out.println( zonedDatetimeFromClock );
        System.out.println( zonedDatetimeFromZone );
        
        
        //Duration类，它持有的时间精确到秒和纳秒。这使得我们可以很容易得计算两个日期之间的不同，例子代码如下：
        // Get duration between two dates
        LocalDateTime from = LocalDateTime.of( 2014, Month.APRIL, 16, 0, 0, 0 );    //2014-04-16 00:00:00
        LocalDateTime to = LocalDateTime.of( 2015, Month.APRIL, 16, 23, 59, 59 );   //2015-04-16 23:00:00

        Duration duration = Duration.between( from, to );
        System.out.println( "Duration in days: " + duration.toDays() );
        System.out.println( "Duration in hours: " + duration.toHours() );
    }

}
